<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>inf-text-chunk</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.76.0">
<link rel="home" href="index.html" title="libinftext-0.4 Reference Manual">
<link rel="up" href="ch01.html" title="libinftext API reference">
<link rel="prev" href="InfTextUser.html" title="InfTextUser">
<link rel="next" href="InfTextDefaultBuffer.html" title="InfTextDefaultBuffer">
<meta name="generator" content="GTK-Doc V1.15 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
<tr valign="middle">
<td><a accesskey="p" href="InfTextUser.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
<td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
<th width="100%" align="center">libinftext-0.4 Reference Manual</th>
<td><a accesskey="n" href="InfTextDefaultBuffer.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr>
<tr><td colspan="5" class="shortcuts">
<a href="#libinftext-0.4-inf-text-chunk.synopsis" class="shortcut">Top</a>
                   | 
                  <a href="#libinftext-0.4-inf-text-chunk.description" class="shortcut">Description</a>
</td></tr>
</table>
<div class="refentry" title="inf-text-chunk">
<a name="libinftext-0.4-inf-text-chunk"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle"><a name="libinftext-0.4-inf-text-chunk.top_of_page"></a>inf-text-chunk</span></h2>
<p>inf-text-chunk</p>
</td>
<td valign="top" align="right"></td>
</tr></table></div>
<div class="refsynopsisdiv" title="Synopsis">
<a name="libinftext-0.4-inf-text-chunk.synopsis"></a><h2>Synopsis</h2>
<pre class="synopsis">                    <a class="link" href="libinftext-0.4-inf-text-chunk.html#InfTextChunk" title="InfTextChunk">InfTextChunk</a>;
                    <a class="link" href="libinftext-0.4-inf-text-chunk.html#InfTextChunkIter" title="InfTextChunkIter">InfTextChunkIter</a>;
<a class="link" href="libinftext-0.4-inf-text-chunk.html#InfTextChunk" title="InfTextChunk"><span class="returnvalue">InfTextChunk</span></a> *      <a class="link" href="libinftext-0.4-inf-text-chunk.html#inf-text-chunk-new" title="inf_text_chunk_new ()">inf_text_chunk_new</a>                  (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *encoding</code></em>);
<a class="link" href="libinftext-0.4-inf-text-chunk.html#InfTextChunk" title="InfTextChunk"><span class="returnvalue">InfTextChunk</span></a> *      <a class="link" href="libinftext-0.4-inf-text-chunk.html#inf-text-chunk-copy" title="inf_text_chunk_copy ()">inf_text_chunk_copy</a>                 (<em class="parameter"><code><a class="link" href="libinftext-0.4-inf-text-chunk.html#InfTextChunk" title="InfTextChunk"><span class="type">InfTextChunk</span></a> *self</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="libinftext-0.4-inf-text-chunk.html#inf-text-chunk-free" title="inf_text_chunk_free ()">inf_text_chunk_free</a>                 (<em class="parameter"><code><a class="link" href="libinftext-0.4-inf-text-chunk.html#InfTextChunk" title="InfTextChunk"><span class="type">InfTextChunk</span></a> *self</code></em>);
const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       <a class="link" href="libinftext-0.4-inf-text-chunk.html#inf-text-chunk-get-encoding" title="inf_text_chunk_get_encoding ()">inf_text_chunk_get_encoding</a>         (<em class="parameter"><code><a class="link" href="libinftext-0.4-inf-text-chunk.html#InfTextChunk" title="InfTextChunk"><span class="type">InfTextChunk</span></a> *self</code></em>);
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               <a class="link" href="libinftext-0.4-inf-text-chunk.html#inf-text-chunk-get-length" title="inf_text_chunk_get_length ()">inf_text_chunk_get_length</a>           (<em class="parameter"><code><a class="link" href="libinftext-0.4-inf-text-chunk.html#InfTextChunk" title="InfTextChunk"><span class="type">InfTextChunk</span></a> *self</code></em>);
<a class="link" href="libinftext-0.4-inf-text-chunk.html#InfTextChunk" title="InfTextChunk"><span class="returnvalue">InfTextChunk</span></a> *      <a class="link" href="libinftext-0.4-inf-text-chunk.html#inf-text-chunk-substring" title="inf_text_chunk_substring ()">inf_text_chunk_substring</a>            (<em class="parameter"><code><a class="link" href="libinftext-0.4-inf-text-chunk.html#InfTextChunk" title="InfTextChunk"><span class="type">InfTextChunk</span></a> *self</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> begin</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> length</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="libinftext-0.4-inf-text-chunk.html#inf-text-chunk-insert-text" title="inf_text_chunk_insert_text ()">inf_text_chunk_insert_text</a>          (<em class="parameter"><code><a class="link" href="libinftext-0.4-inf-text-chunk.html#InfTextChunk" title="InfTextChunk"><span class="type">InfTextChunk</span></a> *self</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> offset</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gconstpointer"><span class="type">gconstpointer</span></a> text</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> bytes</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> length</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> author</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="libinftext-0.4-inf-text-chunk.html#inf-text-chunk-insert-chunk" title="inf_text_chunk_insert_chunk ()">inf_text_chunk_insert_chunk</a>         (<em class="parameter"><code><a class="link" href="libinftext-0.4-inf-text-chunk.html#InfTextChunk" title="InfTextChunk"><span class="type">InfTextChunk</span></a> *self</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> offset</code></em>,
                                                         <em class="parameter"><code><a class="link" href="libinftext-0.4-inf-text-chunk.html#InfTextChunk" title="InfTextChunk"><span class="type">InfTextChunk</span></a> *text</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="libinftext-0.4-inf-text-chunk.html#inf-text-chunk-erase" title="inf_text_chunk_erase ()">inf_text_chunk_erase</a>                (<em class="parameter"><code><a class="link" href="libinftext-0.4-inf-text-chunk.html#InfTextChunk" title="InfTextChunk"><span class="type">InfTextChunk</span></a> *self</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> begin</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> length</code></em>);
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a>            <a class="link" href="libinftext-0.4-inf-text-chunk.html#inf-text-chunk-get-text" title="inf_text_chunk_get_text ()">inf_text_chunk_get_text</a>             (<em class="parameter"><code><a class="link" href="libinftext-0.4-inf-text-chunk.html#InfTextChunk" title="InfTextChunk"><span class="type">InfTextChunk</span></a> *self</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> *length</code></em>);
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="libinftext-0.4-inf-text-chunk.html#inf-text-chunk-equal" title="inf_text_chunk_equal ()">inf_text_chunk_equal</a>                (<em class="parameter"><code><a class="link" href="libinftext-0.4-inf-text-chunk.html#InfTextChunk" title="InfTextChunk"><span class="type">InfTextChunk</span></a> *self</code></em>,
                                                         <em class="parameter"><code><a class="link" href="libinftext-0.4-inf-text-chunk.html#InfTextChunk" title="InfTextChunk"><span class="type">InfTextChunk</span></a> *other</code></em>);
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="libinftext-0.4-inf-text-chunk.html#inf-text-chunk-iter-init" title="inf_text_chunk_iter_init ()">inf_text_chunk_iter_init</a>            (<em class="parameter"><code><a class="link" href="libinftext-0.4-inf-text-chunk.html#InfTextChunk" title="InfTextChunk"><span class="type">InfTextChunk</span></a> *self</code></em>,
                                                         <em class="parameter"><code><a class="link" href="libinftext-0.4-inf-text-chunk.html#InfTextChunkIter" title="InfTextChunkIter"><span class="type">InfTextChunkIter</span></a> *iter</code></em>);
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="libinftext-0.4-inf-text-chunk.html#inf-text-chunk-iter-next" title="inf_text_chunk_iter_next ()">inf_text_chunk_iter_next</a>            (<em class="parameter"><code><a class="link" href="libinftext-0.4-inf-text-chunk.html#InfTextChunkIter" title="InfTextChunkIter"><span class="type">InfTextChunkIter</span></a> *iter</code></em>);
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="libinftext-0.4-inf-text-chunk.html#inf-text-chunk-iter-prev" title="inf_text_chunk_iter_prev ()">inf_text_chunk_iter_prev</a>            (<em class="parameter"><code><a class="link" href="libinftext-0.4-inf-text-chunk.html#InfTextChunkIter" title="InfTextChunkIter"><span class="type">InfTextChunkIter</span></a> *iter</code></em>);
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gconstpointer"><span class="returnvalue">gconstpointer</span></a>       <a class="link" href="libinftext-0.4-inf-text-chunk.html#inf-text-chunk-iter-get-text" title="inf_text_chunk_iter_get_text ()">inf_text_chunk_iter_get_text</a>        (<em class="parameter"><code><a class="link" href="libinftext-0.4-inf-text-chunk.html#InfTextChunkIter" title="InfTextChunkIter"><span class="type">InfTextChunkIter</span></a> *iter</code></em>);
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               <a class="link" href="libinftext-0.4-inf-text-chunk.html#inf-text-chunk-iter-get-length" title="inf_text_chunk_iter_get_length ()">inf_text_chunk_iter_get_length</a>      (<em class="parameter"><code><a class="link" href="libinftext-0.4-inf-text-chunk.html#InfTextChunkIter" title="InfTextChunkIter"><span class="type">InfTextChunkIter</span></a> *iter</code></em>);
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="returnvalue">gsize</span></a>               <a class="link" href="libinftext-0.4-inf-text-chunk.html#inf-text-chunk-iter-get-bytes" title="inf_text_chunk_iter_get_bytes ()">inf_text_chunk_iter_get_bytes</a>       (<em class="parameter"><code><a class="link" href="libinftext-0.4-inf-text-chunk.html#InfTextChunkIter" title="InfTextChunkIter"><span class="type">InfTextChunkIter</span></a> *iter</code></em>);
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               <a class="link" href="libinftext-0.4-inf-text-chunk.html#inf-text-chunk-iter-get-author" title="inf_text_chunk_iter_get_author ()">inf_text_chunk_iter_get_author</a>      (<em class="parameter"><code><a class="link" href="libinftext-0.4-inf-text-chunk.html#InfTextChunkIter" title="InfTextChunkIter"><span class="type">InfTextChunkIter</span></a> *iter</code></em>);
</pre>
</div>
<div class="refsect1" title="Description">
<a name="libinftext-0.4-inf-text-chunk.description"></a><h2>Description</h2>
<p>
</p>
</div>
<div class="refsect1" title="Details">
<a name="libinftext-0.4-inf-text-chunk.details"></a><h2>Details</h2>
<div class="refsect2" title="InfTextChunk">
<a name="InfTextChunk"></a><h3>InfTextChunk</h3>
<pre class="programlisting">typedef struct _InfTextChunk InfTextChunk;</pre>
<p>
</p>
</div>
<hr>
<div class="refsect2" title="InfTextChunkIter">
<a name="InfTextChunkIter"></a><h3>InfTextChunkIter</h3>
<pre class="programlisting">typedef struct {
  InfTextChunk* chunk;
  GSequenceIter* first;
  GSequenceIter* second;
} InfTextChunkIter;
</pre>
<p>
</p>
</div>
<hr>
<div class="refsect2" title="inf_text_chunk_new ()">
<a name="inf-text-chunk-new"></a><h3>inf_text_chunk_new ()</h3>
<pre class="programlisting"><a class="link" href="libinftext-0.4-inf-text-chunk.html#InfTextChunk" title="InfTextChunk"><span class="returnvalue">InfTextChunk</span></a> *      inf_text_chunk_new                  (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *encoding</code></em>);</pre>
<p>
Creates a new <a class="link" href="libinftext-0.4-inf-text-chunk.html#InfTextChunk" title="InfTextChunk"><span class="type">InfTextChunk</span></a> with no initial content that holds text
in the given encoding. TODO: Allow binary data with <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> encoding.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>encoding</code></em> :</span></p></td>
<td>A content encoding, such as "UTF-8" or "LATIN1".
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> A new <a class="link" href="libinftext-0.4-inf-text-chunk.html#InfTextChunk" title="InfTextChunk"><span class="type">InfTextChunk</span></a>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="inf_text_chunk_copy ()">
<a name="inf-text-chunk-copy"></a><h3>inf_text_chunk_copy ()</h3>
<pre class="programlisting"><a class="link" href="libinftext-0.4-inf-text-chunk.html#InfTextChunk" title="InfTextChunk"><span class="returnvalue">InfTextChunk</span></a> *      inf_text_chunk_copy                 (<em class="parameter"><code><a class="link" href="libinftext-0.4-inf-text-chunk.html#InfTextChunk" title="InfTextChunk"><span class="type">InfTextChunk</span></a> *self</code></em>);</pre>
<p>
Returns a copy of <em class="parameter"><code>self</code></em>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
<td>A <a class="link" href="libinftext-0.4-inf-text-chunk.html#InfTextChunk" title="InfTextChunk"><span class="type">InfTextChunk</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> A new <a class="link" href="libinftext-0.4-inf-text-chunk.html#InfTextChunk" title="InfTextChunk"><span class="type">InfTextChunk</span></a>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="inf_text_chunk_free ()">
<a name="inf-text-chunk-free"></a><h3>inf_text_chunk_free ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                inf_text_chunk_free                 (<em class="parameter"><code><a class="link" href="libinftext-0.4-inf-text-chunk.html#InfTextChunk" title="InfTextChunk"><span class="type">InfTextChunk</span></a> *self</code></em>);</pre>
<p>
Frees a <a class="link" href="libinftext-0.4-inf-text-chunk.html#InfTextChunk" title="InfTextChunk"><span class="type">InfTextChunk</span></a> allocated with <a class="link" href="libinftext-0.4-inf-text-chunk.html#inf-text-chunk-new" title="inf_text_chunk_new ()"><code class="function">inf_text_chunk_new()</code></a>,
<a class="link" href="libinftext-0.4-inf-text-chunk.html#inf-text-chunk-copy" title="inf_text_chunk_copy ()"><code class="function">inf_text_chunk_copy()</code></a> or <a class="link" href="libinftext-0.4-inf-text-chunk.html#inf-text-chunk-substring" title="inf_text_chunk_substring ()"><code class="function">inf_text_chunk_substring()</code></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
<td>A <a class="link" href="libinftext-0.4-inf-text-chunk.html#InfTextChunk" title="InfTextChunk"><span class="type">InfTextChunk</span></a>.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="inf_text_chunk_get_encoding ()">
<a name="inf-text-chunk-get-encoding"></a><h3>inf_text_chunk_get_encoding ()</h3>
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       inf_text_chunk_get_encoding         (<em class="parameter"><code><a class="link" href="libinftext-0.4-inf-text-chunk.html#InfTextChunk" title="InfTextChunk"><span class="type">InfTextChunk</span></a> *self</code></em>);</pre>
<p>
Returns the character encoding in which the content of <em class="parameter"><code>self</code></em> is encoded.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
<td>A <a class="link" href="libinftext-0.4-inf-text-chunk.html#InfTextChunk" title="InfTextChunk"><span class="type">InfTextChunk</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> The encoding of <em class="parameter"><code>self</code></em>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="inf_text_chunk_get_length ()">
<a name="inf-text-chunk-get-length"></a><h3>inf_text_chunk_get_length ()</h3>
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               inf_text_chunk_get_length           (<em class="parameter"><code><a class="link" href="libinftext-0.4-inf-text-chunk.html#InfTextChunk" title="InfTextChunk"><span class="type">InfTextChunk</span></a> *self</code></em>);</pre>
<p>
Returns the number of characters contained in <em class="parameter"><code>self</code></em>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
<td>A <a class="link" href="libinftext-0.4-inf-text-chunk.html#InfTextChunk" title="InfTextChunk"><span class="type">InfTextChunk</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> The number of characters of <em class="parameter"><code>self</code></em>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="inf_text_chunk_substring ()">
<a name="inf-text-chunk-substring"></a><h3>inf_text_chunk_substring ()</h3>
<pre class="programlisting"><a class="link" href="libinftext-0.4-inf-text-chunk.html#InfTextChunk" title="InfTextChunk"><span class="returnvalue">InfTextChunk</span></a> *      inf_text_chunk_substring            (<em class="parameter"><code><a class="link" href="libinftext-0.4-inf-text-chunk.html#InfTextChunk" title="InfTextChunk"><span class="type">InfTextChunk</span></a> *self</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> begin</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> length</code></em>);</pre>
<p>
Returns a new <a class="link" href="libinftext-0.4-inf-text-chunk.html#InfTextChunk" title="InfTextChunk"><span class="type">InfTextChunk</span></a> containing a substring of <em class="parameter"><code>self</code></em>, beginning
at character offset <em class="parameter"><code>begin</code></em> and <em class="parameter"><code>length</code></em> characters long.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
<td>A <a class="link" href="libinftext-0.4-inf-text-chunk.html#InfTextChunk" title="InfTextChunk"><span class="type">InfTextChunk</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>begin</code></em> :</span></p></td>
<td>A character offset into <em class="parameter"><code>self</code></em>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>length</code></em> :</span></p></td>
<td>The length of the text to extract.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> A new <a class="link" href="libinftext-0.4-inf-text-chunk.html#InfTextChunk" title="InfTextChunk"><span class="type">InfTextChunk</span></a>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="inf_text_chunk_insert_text ()">
<a name="inf-text-chunk-insert-text"></a><h3>inf_text_chunk_insert_text ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                inf_text_chunk_insert_text          (<em class="parameter"><code><a class="link" href="libinftext-0.4-inf-text-chunk.html#InfTextChunk" title="InfTextChunk"><span class="type">InfTextChunk</span></a> *self</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> offset</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gconstpointer"><span class="type">gconstpointer</span></a> text</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> bytes</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> length</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> author</code></em>);</pre>
<p>
Inserts text written by <em class="parameter"><code>author</code></em> into <em class="parameter"><code>self</code></em>. <em class="parameter"><code>text</code></em> is expected to be in
the chunk's encoding.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
<td>A <a class="link" href="libinftext-0.4-inf-text-chunk.html#InfTextChunk" title="InfTextChunk"><span class="type">InfTextChunk</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>offset</code></em> :</span></p></td>
<td>Character offset at which to insert text
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td>
<td>Text to insert.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>bytes</code></em> :</span></p></td>
<td>Number of bytes of <em class="parameter"><code>text</code></em>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>length</code></em> :</span></p></td>
<td>Number of characters contained in <em class="parameter"><code>text</code></em>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>author</code></em> :</span></p></td>
<td>User that wrote <em class="parameter"><code>text</code></em>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="inf_text_chunk_insert_chunk ()">
<a name="inf-text-chunk-insert-chunk"></a><h3>inf_text_chunk_insert_chunk ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                inf_text_chunk_insert_chunk         (<em class="parameter"><code><a class="link" href="libinftext-0.4-inf-text-chunk.html#InfTextChunk" title="InfTextChunk"><span class="type">InfTextChunk</span></a> *self</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> offset</code></em>,
                                                         <em class="parameter"><code><a class="link" href="libinftext-0.4-inf-text-chunk.html#InfTextChunk" title="InfTextChunk"><span class="type">InfTextChunk</span></a> *text</code></em>);</pre>
<p>
Inserts <em class="parameter"><code>text</code></em> into <em class="parameter"><code>self</code></em> at position <em class="parameter"><code>offset</code></em>. <em class="parameter"><code>text</code></em> and <em class="parameter"><code>self</code></em> must
have the same encoding.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
<td>A <a class="link" href="libinftext-0.4-inf-text-chunk.html#InfTextChunk" title="InfTextChunk"><span class="type">InfTextChunk</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>offset</code></em> :</span></p></td>
<td>Character offset at which to insert text.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td>
<td>Chunk to insert into <em class="parameter"><code>self</code></em>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="inf_text_chunk_erase ()">
<a name="inf-text-chunk-erase"></a><h3>inf_text_chunk_erase ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                inf_text_chunk_erase                (<em class="parameter"><code><a class="link" href="libinftext-0.4-inf-text-chunk.html#InfTextChunk" title="InfTextChunk"><span class="type">InfTextChunk</span></a> *self</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> begin</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> length</code></em>);</pre>
<p>
Removes <em class="parameter"><code>length</code></em> characters of <em class="parameter"><code>self</code></em>, starting from character offset <em class="parameter"><code>begin</code></em>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
<td>A <a class="link" href="libinftext-0.4-inf-text-chunk.html#InfTextChunk" title="InfTextChunk"><span class="type">InfTextChunk</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>begin</code></em> :</span></p></td>
<td>A character offset into <em class="parameter"><code>self</code></em>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>length</code></em> :</span></p></td>
<td>Number of characters to erase.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="inf_text_chunk_get_text ()">
<a name="inf-text-chunk-get-text"></a><h3>inf_text_chunk_get_text ()</h3>
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a>            inf_text_chunk_get_text             (<em class="parameter"><code><a class="link" href="libinftext-0.4-inf-text-chunk.html#InfTextChunk" title="InfTextChunk"><span class="type">InfTextChunk</span></a> *self</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> *length</code></em>);</pre>
<p>
Returns the content of <em class="parameter"><code>self</code></em> as an array. The text is encoded in
<em class="parameter"><code>self</code></em>'s encoding. <em class="parameter"><code>length</code></em> is set to the number of bytes in the returned
buffer, if non-<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. The result is _not_ zero-terminated.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
<td>A <a class="link" href="libinftext-0.4-inf-text-chunk.html#InfTextChunk" title="InfTextChunk"><span class="type">InfTextChunk</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>length</code></em> :</span></p></td>
<td>Location to write the number of bytes to, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> Content of <em class="parameter"><code>self</code></em>. Free with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> if no longer in use.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="inf_text_chunk_equal ()">
<a name="inf-text-chunk-equal"></a><h3>inf_text_chunk_equal ()</h3>
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            inf_text_chunk_equal                (<em class="parameter"><code><a class="link" href="libinftext-0.4-inf-text-chunk.html#InfTextChunk" title="InfTextChunk"><span class="type">InfTextChunk</span></a> *self</code></em>,
                                                         <em class="parameter"><code><a class="link" href="libinftext-0.4-inf-text-chunk.html#InfTextChunk" title="InfTextChunk"><span class="type">InfTextChunk</span></a> *other</code></em>);</pre>
<p>
Returns whether the two text chunks contain the same text and the same
segments were written by the same authors.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
<td>A <a class="link" href="libinftext-0.4-inf-text-chunk.html#InfTextChunk" title="InfTextChunk"><span class="type">InfTextChunk</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>other</code></em> :</span></p></td>
<td>Another <a class="link" href="libinftext-0.4-inf-text-chunk.html#InfTextChunk" title="InfTextChunk"><span class="type">InfTextChunk</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> Whether the two chunks are equal.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="inf_text_chunk_iter_init ()">
<a name="inf-text-chunk-iter-init"></a><h3>inf_text_chunk_iter_init ()</h3>
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            inf_text_chunk_iter_init            (<em class="parameter"><code><a class="link" href="libinftext-0.4-inf-text-chunk.html#InfTextChunk" title="InfTextChunk"><span class="type">InfTextChunk</span></a> *self</code></em>,
                                                         <em class="parameter"><code><a class="link" href="libinftext-0.4-inf-text-chunk.html#InfTextChunkIter" title="InfTextChunkIter"><span class="type">InfTextChunkIter</span></a> *iter</code></em>);</pre>
<p>
Sets <em class="parameter"><code>iter</code></em> to point to the first segment of <em class="parameter"><code>self</code></em>. If there are no
segments (i.e. <em class="parameter"><code>self</code></em> is empty), <em class="parameter"><code>iter</code></em> is left untouched and the function
returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
<td>A <a class="link" href="libinftext-0.4-inf-text-chunk.html#InfTextChunk" title="InfTextChunk"><span class="type">InfTextChunk</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>iter</code></em> :</span></p></td>
<td>A <a class="link" href="libinftext-0.4-inf-text-chunk.html#InfTextChunkIter" title="InfTextChunkIter"><span class="type">InfTextChunkIter</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> Whether <em class="parameter"><code>iter</code></em> was set.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="inf_text_chunk_iter_next ()">
<a name="inf-text-chunk-iter-next"></a><h3>inf_text_chunk_iter_next ()</h3>
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            inf_text_chunk_iter_next            (<em class="parameter"><code><a class="link" href="libinftext-0.4-inf-text-chunk.html#InfTextChunkIter" title="InfTextChunkIter"><span class="type">InfTextChunkIter</span></a> *iter</code></em>);</pre>
<p>
Sets <em class="parameter"><code>iter</code></em> to point to the next segment. If <em class="parameter"><code>iter</code></em> already points to the
last segment, the function returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>iter</code></em> :</span></p></td>
<td>An initialized <a class="link" href="libinftext-0.4-inf-text-chunk.html#InfTextChunkIter" title="InfTextChunkIter"><span class="type">InfTextChunkIter</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> Whether <em class="parameter"><code>iter</code></em> was set.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="inf_text_chunk_iter_prev ()">
<a name="inf-text-chunk-iter-prev"></a><h3>inf_text_chunk_iter_prev ()</h3>
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            inf_text_chunk_iter_prev            (<em class="parameter"><code><a class="link" href="libinftext-0.4-inf-text-chunk.html#InfTextChunkIter" title="InfTextChunkIter"><span class="type">InfTextChunkIter</span></a> *iter</code></em>);</pre>
<p>
Sets <em class="parameter"><code>iter</code></em> to point to the previous segment. If <em class="parameter"><code>iter</code></em> already points to
the first segment, the function returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>iter</code></em> :</span></p></td>
<td>An initialized <a class="link" href="libinftext-0.4-inf-text-chunk.html#InfTextChunkIter" title="InfTextChunkIter"><span class="type">InfTextChunkIter</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> Whether <em class="parameter"><code>iter</code></em> has changed.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="inf_text_chunk_iter_get_text ()">
<a name="inf-text-chunk-iter-get-text"></a><h3>inf_text_chunk_iter_get_text ()</h3>
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gconstpointer"><span class="returnvalue">gconstpointer</span></a>       inf_text_chunk_iter_get_text        (<em class="parameter"><code><a class="link" href="libinftext-0.4-inf-text-chunk.html#InfTextChunkIter" title="InfTextChunkIter"><span class="type">InfTextChunkIter</span></a> *iter</code></em>);</pre>
<p>
Returns the text of the segment <em class="parameter"><code>iter</code></em> points to. The text is in the
underlaying <a class="link" href="libinftext-0.4-inf-text-chunk.html#InfTextChunk" title="InfTextChunk"><span class="type">InfTextChunk</span></a>'s encoding.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>iter</code></em> :</span></p></td>
<td>An initialized <a class="link" href="libinftext-0.4-inf-text-chunk.html#InfTextChunkIter" title="InfTextChunkIter"><span class="type">InfTextChunkIter</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> The text of the segment <em class="parameter"><code>iter</code></em> points to.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="inf_text_chunk_iter_get_length ()">
<a name="inf-text-chunk-iter-get-length"></a><h3>inf_text_chunk_iter_get_length ()</h3>
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               inf_text_chunk_iter_get_length      (<em class="parameter"><code><a class="link" href="libinftext-0.4-inf-text-chunk.html#InfTextChunkIter" title="InfTextChunkIter"><span class="type">InfTextChunkIter</span></a> *iter</code></em>);</pre>
<p>
Returns the number of characters in the segment <em class="parameter"><code>iter</code></em> points to.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>iter</code></em> :</span></p></td>
<td>An initialized <a class="link" href="libinftext-0.4-inf-text-chunk.html#InfTextChunkIter" title="InfTextChunkIter"><span class="type">InfTextChunkIter</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> The number of characters in the segment <em class="parameter"><code>iter</code></em> points to.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="inf_text_chunk_iter_get_bytes ()">
<a name="inf-text-chunk-iter-get-bytes"></a><h3>inf_text_chunk_iter_get_bytes ()</h3>
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="returnvalue">gsize</span></a>               inf_text_chunk_iter_get_bytes       (<em class="parameter"><code><a class="link" href="libinftext-0.4-inf-text-chunk.html#InfTextChunkIter" title="InfTextChunkIter"><span class="type">InfTextChunkIter</span></a> *iter</code></em>);</pre>
<p>
Returns the number of bytes in the segment <em class="parameter"><code>iter</code></em> points to.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>iter</code></em> :</span></p></td>
<td>An initialized <a class="link" href="libinftext-0.4-inf-text-chunk.html#InfTextChunkIter" title="InfTextChunkIter"><span class="type">InfTextChunkIter</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> The number of bytes in the segment <em class="parameter"><code>iter</code></em> points to.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="inf_text_chunk_iter_get_author ()">
<a name="inf-text-chunk-iter-get-author"></a><h3>inf_text_chunk_iter_get_author ()</h3>
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               inf_text_chunk_iter_get_author      (<em class="parameter"><code><a class="link" href="libinftext-0.4-inf-text-chunk.html#InfTextChunkIter" title="InfTextChunkIter"><span class="type">InfTextChunkIter</span></a> *iter</code></em>);</pre>
<p>
Returns the user ID of the author of the segment <em class="parameter"><code>iter</code></em> points to.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>iter</code></em> :</span></p></td>
<td>An initialized <a class="link" href="libinftext-0.4-inf-text-chunk.html#InfTextChunkIter" title="InfTextChunkIter"><span class="type">InfTextChunkIter</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> The user ID of the author of the segment <em class="parameter"><code>iter</code></em> points to.
</td>
</tr>
</tbody>
</table></div>
</div>
</div>
</div>
<div class="footer">
<hr>
          Generated by GTK-Doc V1.15</div>
</body>
</html>